home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / Libraries / Sherlock 2.0 / Mac v2.0 docs / Text Docs / Mac Errors .txt < prev    next >
Text File  |  1996-04-05  |  3KB  |  89 lines
  1. Sherlock Error Messages
  2.  
  3.  
  4.  
  5. This appendix lists the error messages that are generated by the Sherlock support routines while 
  6. your program is running.  The following abbreviations will be used in the explanation of these 
  7. error messages:
  8.  
  9.  
  10. <addr>     The hexadecimal address of the macro where the error occurred.
  11.  
  12. <char>     A single character.
  13.  
  14. <name>     The name of the macro: TICK, TRACE, etc.
  15.  
  16. <on_prefix>      The on_prefix parameter to the SL_PARSE macro.
  17.  
  18. <off_prefix>     The off_string parameter to the SL_PARSE macro.
  19.  
  20. <string>     The string representing the tracepoint name. 
  21.  
  22.     
  23.  
  24.     sl_check:<name>: null string @ <addr>.
  25.  
  26.  
  27. The tracepoint name passed to a macro was the NULL string.
  28.  
  29.     
  30.  
  31.     sl_check:<name>: bad character <char> in <string> @ <addr>.
  32.  
  33.  
  34. The tracepoint name of a macro contains an invalid character.  Only letters, numerals and the 
  35. underscore character are valid in tracepoint names.  However, tracepoint names may be preceded 
  36. by a leading minus sign in Sherlock macros.
  37.  
  38.  
  39.     sl_check: <name>: run on argument: <string> @ <addr>.
  40.  
  41.  
  42. The tracepoint name passed to a macro contained more than 25 characters.
  43.  
  44.     
  45.  
  46.     sl_init: Header version does not match run-time version.
  47.  
  48.  
  49. The version of the macros in the file sl.h or sl2.h does not match the version of the code in the file 
  50. sl_init.c.  Change either the version of the header file that you use to compile your programs or the 
  51. version of the support routines that are linked with your program.
  52.  
  53.  
  54.     sl_ret:  Entry/Exit mismatch at exit point <string>.
  55.  
  56.     Check for missing or misnamed exit macros.
  57.  
  58.     Dump of call stack:
  59.  
  60.  
  61. The tracepoint name passed to an exit macro does not match the tracepoint name on top of the 
  62. timing stack.  This indicates that name of the most recently executed entry macro does not match 
  63. the name of the current exit macro.  As an aid in finding out where the problem occurred, the 
  64. tracepoint names on the call stack are printed out.
  65.  
  66.  
  67.     Lone <on_prefix>
  68.  
  69.  
  70. The on_prefix appeared alone on the command line.  It must be followed immediately with no 
  71. intervening spaces by a tracepoint name. This command line error  immediately terminates the 
  72. program.
  73.  
  74.  
  75.     Lone <off_prefix>
  76.  
  77.  
  78. The off_prefix appeared alone on the command line.  It must be followed immediately with no 
  79. intervening spaces by a tracepoint name. This command line error  immediately terminates the 
  80. program.
  81.  
  82.  
  83.     Trace table overflow.
  84.  
  85.  
  86. Too many tracepoint names were encountered during execution of your program.  Tracepoints 
  87. with the same names do not add to this total.  Neither do tracepoints that are never executed.  
  88. Increase the SL_MAX_NODES constant in the file sl2.h and recompile.
  89.